Greptile Summary

This PR improves the AI agent skill system by replacing the generic "query status, turn on/off, set properties" description with a concrete, action-oriented one derived from real property metadata, and adds per-profile ## Agent Guidance sections listing common agent mistakes. The template is updated to render a capability bullet list and conditionally emit the new guidance block.

Key changes:

• _build_description() now inspects actual Property objects (enums, min/max ranges, units) to generate compact, machine-readable frontmatter descriptions
• _PROFILE_DESCRIPTION_NOTES adds one-line profile-specific clarifications appended to the description (petfeeder, light, bulb)
• _PROFILE_PITFALLS provides per-profile pitfall bullets rendered in a new ## Agent Guidance section (petfeeder, airfryer, light, bulb)
• Two concrete wrong property names remain in the pitfall data: food_level (should be food_empty, the actual boolean status field) in the petfeeder pitfall, and temperature/timer (should be target_temp/target_time) in the airfryer pitfall — both will silently mislead agents reading the generated skill files

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Device + Profile] --> B[build_device_context]
    B --> C[properties / trigger_names / actions]
    C --> D[_build_description]
    C --> E[_build_pitfalls]
    D --> F[frontmatter description string]
    E --> G[pitfalls list]
    F & G --> H[Jinja2: device_skill.md.j2]
    H --> I[SKILL.md frontmatter\nname / description / metadata]
    H --> J[## What This Skill Does\nbullet list]
    H --> K{pitfalls?}
    K -- yes --> L[## Agent Guidance\nwarning bullets]
    K -- no --> M[skip section]
    L & J & I --> N[Written to skills/device-slug/SKILL.md]

_{Reviews (2): Last reviewed commit: "Update src/iotcli/skills/generator.py" | Re-trigger Greptile}

@greptile review